.. _cmmIntHandlerSetup:

cmmIntHandlerSetup
========================
------------------------

SYNOPSIS
```````````

.. code-block:: none

    VT_I4 cmmIntHandlerSetup(
        [in] VT_I4 HandlerType, [in] VT_HANDLE Handler, 
        [in] VT_UI4 nMessage, [in] VT_HANDLE IParam
        )

     
DESCRIPTION
```````````````

- 인터럽트 이벤트 핸들러를 등록합니다. CMMSDK 에서는 윈도우 메시지 방식, 이벤트 객체 방식, 콜백 함수 방식등의
  인터럽트 처리를 수행할 수 있으며, 해당 인터럽트가 발생되었을 때, 지정된 HandlerType 에 따른 처리가 이루어지게 됩니다.
  이벤트 처리에 대한 보다 자세한 정보는 ㈜ 커미조아 CMMSDK 에서 제공하는 예제 프로그램의 실제 코드를 통해서
  확인하시는 것도 좋은 방법입니다.


PARAMETER
```````````

- HandlerType : 인터럽트 핸들러의 종류를 지정합니다. 이 값의 종류는 아래와 같이 3 가지로 지정할 수 있습니다

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 (cmIHT_MESSAGE), "
                        윈도우 메시지 전달방식을 통하여 인터럽트를 통지합니다.
                         • 장점: GUI 관련 작업을 이벤트핸들러에서 직접 수행할 수 있다.
                         • 단점: 윈도우가 메시지루프 상황에 따라서 상당한 지연시간을 가질 수 있다. "
  1 (cmIHT_EVENT), "
                        이벤트 객체를 통하여 인터럽트를 통지합니다.
                         • 장점: 메시지 전달 방식보다 비교적 적은 지연시간을 가질 수 있다.
                         • 단점: 사용하기가 복잡하다. "
  2 (cmIHT_CALLBACK), "
                        콜백 함수를 통하여 인터럽트를 통지합니다. 이 방식이 가장
                        권장되는 방식입니다.
                        • 장점: 메시지 전달의 지연시간이 3 가지 방식 중에서 가장 적다.
                        • 단점: GUI 관련 작업을 수행할 수 없다. "
 
\

- Handler : 이 매개변수의 의미는 HandlerType 의 설정에 따라서 다음과 같이 달라집니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  HandlerType 설정값, Handler 매개변수의 의미
  0 (메시지 방식) 일때, Handler 매개변수는 윈도우 핸들을 의미합니다.
  1 (이벤트 방식) 일때, Handler 매개변수는 이벤트 객체를 의미합니다.
  2 (콜백 방식) 일때, Handler 매개변수는 콜백 함수를 의미합니다.

RETURN VALUE
`````````````
.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  cmERR_NONE, 수행 성공